home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 049a / tnet21.zip / TNET.DOC < prev    next >
Text File  |  1991-08-24  |  35KB  |  1,055 lines
  1.  
  2.  
  3.  
  4. TNET 2.1 Documentation
  5. ======================
  6.  
  7.  
  8.                              TABLE OF CONTENTS
  9.                              -----------------
  10.  
  11.     Introduction ......................................................  2
  12.  
  13.     TNet Distribution .................................................  3
  14.  
  15.     Hardware and Software Requirements ................................  4
  16.  
  17.     Setting up TNet ...................................................  5
  18.  
  19.     Details of TNet's Configuration File ..............................  6
  20.  
  21.     Software Specific Notes ........................................... 10
  22.  
  23.         Wildcat 2.x ................................................... 10
  24.  
  25.         Wildcat 3.x ................................................... 10
  26.  
  27.         MajorBBS ...................................................... 10
  28.  
  29.         UTI Drivers ................................................... 11
  30.  
  31.     Running TNet ...................................................... 12
  32.  
  33.     Network Sysop Message Support ..................................... 13
  34.  
  35.  
  36.     Appendix A: Error Messages ........................................ 14
  37.  
  38.     Appendix B: Message Networks Supporting TNet ...................... 15
  39.  
  40.     Appendix C: Disclaimer ............................................ 16
  41.  
  42.     Appendix D: Acknowledgements ...................................... 17
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61. ---------------------------------------------------------------------------
  62. Technique Computer Systems - TNET.DOC                               Page 1
  63.  
  64.  
  65.  
  66. Introduction
  67. ------------
  68.  
  69.     One  of   the  more  interesting   and  useful   applications  for  BBS
  70.     communications is the ability for one Bulletin Board System to exchange
  71.     public messages and electronic mail with other systems.  These networks
  72.     can be  small and  private, such  as a  link between  BBSs belonging to
  73.     branch offices of a  corporation, or they can  be large public networks
  74.     allowing many hobby  systems to share  messages locally, regionally, or
  75.     even world-wide.
  76.  
  77.     Several standards  for network mail  have evolved, each  with their own
  78.     advantages and limitations.  The  oldest and most widespread networking
  79.     system for personal computers is probably Fido mail.  Another system is
  80.     PCRelay(tm).  A third option, and the  one we have chosen to adopt with
  81.     TNet,  is based  on Mark  "Sparky" Herring's  Qmail or  QWK/REP system.
  82.     This system allows BBS callers to  download, read and reply to messages
  83.     offline through a mail door.  It also allows BBSs to exchange mail with
  84.     each  other in  a  similar fashion,  using the  same  mail door  plus a
  85.     utility  for exporting  and importing  message  packets from  their own
  86.     systems.
  87.  
  88.     TNet allows you, the sysop, to exchange mail with any host system using
  89.     a  QWK-compatible  mail door  capable  of producing  "net  status" mail
  90.     packets.  TNet  extracts outgoing mail  from your BBS  message base and
  91.     creates a reply packet  that you upload to  your host's mail door.  You
  92.     then download a "net status" message  packet from your host, and import
  93.     the new mail into your BBS message base with TNet.
  94.  
  95.     When properly set  up and organized,  this process can  take place as a
  96.     scheduled  event  within  your  BBS,  and  requires  relatively  little
  97.     maintenance or intervention on your part.
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123. ---------------------------------------------------------------------------
  124. Technique Computer Systems - TNET.DOC                               Page 2
  125.  
  126.  
  127.  
  128. TNet Distribution
  129. -----------------
  130.  
  131.     TNet is offered to you as a fully-functional program, in order that you
  132.     can  properly evaluate  its  features and  functions.   The differences
  133.     between the Evaluation Version and  Registered Version are minor and do
  134.     not  affect  program  operation.   The  unregistered  version  of  TNet
  135.     identifies itself as  such in taglines,  and these taglines  may not be
  136.     turned off or disabled.
  137.  
  138.     You are encouraged  to use TNet  for up to  30 days to  determine if it
  139.     meets your needs.   After that time,  you are expected  to register and
  140.     pay  for  the  program.   You  may  not  use  TNet  in  a  business  or
  141.     institutional environment  without registering it,  and each registered
  142.     copy of TNet is licensed for use  at a SINGLE site only.  Site licenses
  143.     and special pricing  for multiple copies  are available (please contact
  144.     Technique Computer Systems for details).
  145.  
  146.     You are  encouraged to  distribute the  Demonstration Version  of TNet,
  147.     providing that all  the files in  the original archive  are present and
  148.     are not tampered  with or altered  in any way.   The file TNET21.ZIP is
  149.     packed using  PKZIP Authenticity  Verification --  if any  of the files
  150.     within  the  archive  do not  produce  the  Technique  Computer Systems
  151.     "Authentic Files Verified" message, please contact us for a fresh copy.
  152.  
  153.     To order TNet, print out the order form (ORDRFORM.DOC) and send it with
  154.     your payment to:
  155.  
  156.               Technique Computer Systems
  157.               #110 - 1841 Oak Bay Avenue
  158.               Victoria, BC
  159.               V8R 1C4
  160.               CANADA
  161.  
  162.     We accept Canadian cheques, US checks, postal money orders, and VISA or
  163.     Mastercard orders (please note that  all credit card orders are charged
  164.     in Canadian funds!).
  165.  
  166.     Phone orders (VISA/MC) - VOICE (604) 598-2141
  167.                                BBS (604) 598-1546
  168.                                FAX (604) 598-4318
  169.  
  170.     Once we have received and  processed your order, your TNet registration
  171.     information will be  available for download from  our support BBS.  The
  172.     opening screens on the BBS will explain how to pick up the information.
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185. ---------------------------------------------------------------------------
  186. Technique Computer Systems - TNET.DOC                               Page 3
  187.  
  188.  
  189.  
  190. Hardware and Software Requirements
  191. ----------------------------------
  192.  
  193.     TNet does  not have  any special  hardware requirements  beyond what is
  194.     needed  to  setup  and  run your  BBS  software  --  its  only specific
  195.     requirement  is sufficient  free disk  space and  memory to  unpack and
  196.     process incoming  mail packets.   It has  been tested  on a  variety of
  197.     single-line  and   multi-line  systems  using   LANtastic,  Novell  and
  198.     DESQview.
  199.  
  200.     To  run TNet  2.1,  you will  need  one of  the  following type  of BBS
  201.     software:
  202.  
  203.               - Wildcat 2.x
  204.               - Wildcat 3.x
  205.               - MajorBBS 5.10 or later
  206.               - Any other type of BBS software with "UTI" drivers
  207.  
  208.     If you intend to  operate as a network  host, supplying network mail to
  209.     nodes calling your BBS,  you will need a QWK  mail door that is capable
  210.     of generating  "net-status" packets.   Currently, Qmail,  Markmail, and
  211.     Rosemail for  PCBoard and  Tomcat for Wildcat  are the  only mail doors
  212.     that generate proper network packets.
  213.  
  214.     You  will  need  a  plain ASCII  text  editor  to  create  and maintain
  215.     configuration files,  and, of course,  a communications  program so you
  216.     can exchange mail with your host.  If you are connecting with a PCBoard
  217.     host, we recommend  and use Robocomm  -- this Shareware  program by Dan
  218.     Parsons is  simple to set  up, reliable, and  designed specifically for
  219.     making QWK mail transfers.  Any communications program with a scripting
  220.     language can be used  as well for doing  automated mail transfers.  You
  221.     will need PKZIP  and PKUNZIP in  your path (or  whichever archiver your
  222.     host's mail door uses to generate packets).
  223.  
  224.     Common sense dictates that you make regularly-scheduled backups of your
  225.     system.   While we've  made  every effort  to  test our  software  in a
  226.     variety of  environments and  configurations, accidents  can happen and
  227.     you could be faced with  hours of work re-installing and re-configuring
  228.     your system should something go wrong.   If you lose your datafiles and
  229.     you don't have a backup,  there's really not much we  can do to help --
  230.     either to diagnose the problem or to fix it.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247. ---------------------------------------------------------------------------
  248. Technique Computer Systems - TNET.DOC                               Page 4
  249.  
  250.  
  251.  
  252. Setting up TNet
  253. ---------------
  254.  
  255.     TNet uses  a plain ASCII  text file for  its configuration information.
  256.     It uses a set of keywords  and options for defining conference numbers,
  257.     paths to message  packets, taglines, public/private  mail, high message
  258.     pointers, etc.   The name  of this  file must  match the  "packet name"
  259.     generated by your host's mail door (i.e. to process BIGBBS.QWK packets,
  260.     you need a configuration file named BIGBBS.CFG).
  261.  
  262.     The  following is  a  brief explanation  of  the keywords  available in
  263.     TNet's configuration file.  Keywords marked  [R] must be present in the
  264.     CFG file;  all others  are optional  and have  suitable default values.
  265.     TNet will  ignore all lines  beginning with a  semicolon.  Each keyword
  266.     must be on a separate line.   Spaces and indents make the configuration
  267.     files  easier for  humans to  read, but  are ignored  by TNet.   A more
  268.     detailed explanation,  with an  example of  a configuration  file, will
  269.     follow this brief list.
  270.  
  271.         SYSTEM    [R] - Type of your BBS system
  272.         WORK          - Work directory used by TNet
  273.         QWKDIR        - Directory to find QWK packets
  274.         REPDIR        - Directory to place REP packets
  275.         LOGFILE       - Name of log file
  276.         PACKER        - Specify command lines for packer/unpacker
  277.         APPEND        - Append exported messages onto existing REP packet
  278.         ATFILTER      - Filter "@-variables"
  279.         VERBOSE       - Verbose log file entries
  280.         TTAG          - Include "TNet 2.1" in tagline
  281.         TCAN          - "Trashcan" - specify user to exclude
  282.         PRIVNAME      - User for which private messages are always exported
  283.         TRANSLATE     - Translate names, see below for more information
  284.         IMPORTTAG     - Tagline definition for imported messages
  285.         EXPORTTAG     - Tagline definition for exported messages
  286.         CONF      [R] - Your local conference identifier
  287.         HUBNUM    [R] - Your hub's conference number for above conference
  288.         PRIVATE       - Allow private messages in this conference
  289.         TAG           - Tagline letter for this conference
  290.         NEXTMSG   [R] - Next message number to be exported by TNet
  291.     
  292.     TNet looks for two configuration files when it starts up - TNET.CFG and
  293.     [HUBNAME].CFG where  [HUBNAME] is the  hub identifier  specified on the
  294.     TNet  command line.   Any options  in  [HUBNAME].CFG will  override the
  295.     corresponding option in TNET.CFG.  This is useful if you call more than
  296.     one hub  for network mail  - the general  options can all  be stored in
  297.     TNET.CFG  while the  BBS-specific conference  configuration information
  298.     can be stored in individual hub configuration files.
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309. ---------------------------------------------------------------------------
  310. Technique Computer Systems - TNET.DOC                               Page 5
  311.  
  312.  
  313.  
  314. Details of TNet's Configuration File
  315. ------------------------------------
  316.  
  317.     The  following sections  describe each  of the  available configuration
  318.     options in detail.
  319.  
  320.     SYSTEM    - This option  must be  set to  one of  the following values:
  321.                 WILDCAT2,  WILDCAT3, MAJORBBS,  or  UTI1.  This  tells TNet
  322.                 what kind of BBS software you are running.
  323.  
  324.     WORK      - This specifies the directory where TNet will place its work
  325.                 files.  Make sure there are no files in this directory that
  326.                 you want to keep, because they  will all be deleted as part
  327.                 of normal operation!
  328.  
  329.     QWKDIR    - This specifies the  directory where TNet  will look to find
  330.                 QWK  packets.   This  will generally  be  the  same  as the
  331.                 directory   where   your   communications   program  places
  332.                 downloaded files.
  333.  
  334.     REPDIR    - This  specifies the  directory  where TNet  will  place REP
  335.                 files  to  be  uploaded.   Make  sure  your  communications
  336.                 program looks in this place when uploading files.
  337.  
  338.     LOGFILE   - This specifies the file name where TNet will place a log of
  339.                 all  network operations.   This  file is  never  deleted by
  340.                 TNet, so you  will want to  make sure you  either delete or
  341.                 archive this file periodically, as  it can grow quite large
  342.                 especially with the verbose logging option.
  343.  
  344.     PACKER    - This  specifies  to TNet  what  the command  lines  are for
  345.                 packing and  unpacking mail packets.   Normally this should
  346.                 be left as is,  unless you have a  good reason for changing
  347.                 it.
  348.  
  349.     APPEND    - When this option is set to Y, TNet will always append newly
  350.                 exported messages on to the  end of an existing REP packet.
  351.                 When set to  N, TNet will  always start a  fresh REP packet
  352.                 whenever it exports mail, even if one already exists.
  353.  
  354.     ATFILTER  - When  this  option  is  set  to  Y,  TNet  will  remove all
  355.                 @-variables of the  form @STRING@, remove  PCBoard @X color
  356.                 codes, and  translate the  "escape" character  used in ANSI
  357.                 control strings  to `  (reverse quote).   PCBoard, Wildcat,
  358.                 and  other  BBS software  use  @-variables  as substitution
  359.                 variables.   Since they  don't make  sense  when used  in a
  360.                 network environment, we recommend leaving this option as Y.
  361.  
  362.     VERBOSE   - When this  option is  set to  Y, TNet  will detail  the To,
  363.                 From, and  Subject lines of  each message in  the log file.
  364.                 Otherwise, just the conference summary totals are placed in
  365.                 the log file.
  366.  
  367.     TTAG      - Normally TNet identifies itself in all taglines appended by
  368.                 TNet.  When this option is set to N, the registered version
  369.                 of TNet will suppress the "TNet 2.1" part of the tagline.
  370.  
  371. ---------------------------------------------------------------------------
  372. Technique Computer Systems - TNET.DOC                               Page 6
  373.  
  374.  
  375.  
  376.     TCAN      - You can specify  names of certain  users whose messages you
  377.                 do not want imported or exported by TNet.  Messages both To
  378.                 and From  such users will  not be moved.   Note that return
  379.                 receipts generated by the BBS software (if applicable) will
  380.                 never be exported into the network.
  381.  
  382.     PRIVNAME  - If  you  have set  a  particular conference  to  No private
  383.                 messages,  but  still want  private  messages  from certain
  384.                 users to  be exported, you  can use this  option to specify
  385.                 their names.   Messages from  users listed  in the PRIVNAME
  386.                 section will always  be exported regardless  of the PRIVATE
  387.                 setting in the conference definition.
  388.  
  389.     TRANSLATE - TNet has  the ability to  translate user  names on imported
  390.                 messages, exported messages, or both.  There are five forms
  391.                 of translates:
  392.  
  393.                 TRANSLATE = <localname>,<hubname>
  394.                     This   option   will  translate   all   occurrences  of
  395.                     <localname> in exported messages  to <hubname>, and all
  396.                     occurrences  of  <hubname>   in  imported  messages  to
  397.                     <localname>.
  398.  
  399.                 IMPTRANS = <localname>,<hubname>
  400.                     This option will translate all occurrences of <hubname>
  401.                     to <localname> in imported messages ONLY.
  402.  
  403.                 EXPTRANS = <localname>,<hubname>
  404.                     This   option   will  translate   all   occurrences  of
  405.                     <localname> to <hubname> in exported messages ONLY.
  406.  
  407.                 LOCSYSOP = <yourname>
  408.                     This is the same as TRANSLATE = SYSOP,<yourname>
  409.                     Use this option ONLY if you  use the name SYSOP on your
  410.                     BBS instead of your real name.
  411.  
  412.                 HUBSYSOP = <hubsysopname>
  413.                     This is the same as TRANSLATE = <hubsysopname>,SYSOP
  414.                     Use this  option ONLY if  your hub sysop  uses the name
  415.                     SYSOP instead of their real name.
  416.  
  417.     IMPORTTAG - Since  your  hub's QWK  mail  door may  not  "tag" outgoing
  418.                 messages  with their  origin  tagline, TNet  must  tag them
  419.                 during  import to  identify their  source.  This  option is
  420.                 used  to  specify a  tagline  letter and  tagline  text for
  421.                 imported messages.  For example:
  422.  
  423.                 IMPORTTAG = T, Your Hub BBS Name and Phone Number
  424.  
  425.                 identifies tagline type T as  the above tagline text.  Then
  426.                 for  each conference  which specifies  tagline type  T, the
  427.                 above tagline text will be placed at the bottom of imported
  428.                 messages if necessary.
  429.  
  430.     EXPORTTAG - This is the tagline  definition for exported messages.  The
  431.                 tagline letter and  tagline text are  specified in the same
  432.                 way as in the IMPORTTAG  option.  In this case, the tagline
  433. ---------------------------------------------------------------------------
  434. Technique Computer Systems - TNET.DOC                               Page 7
  435.  
  436.  
  437.  
  438.                 text  should  identify your  BBS  name and  number  so that
  439.                 outgoing messages can be properly identified.
  440.  
  441.     CONF      - This is  the conference  identifier to  which the following
  442.                 four options  will apply.   Depending on  your BBS software
  443.                 type, different types of values will be used here:
  444.  
  445.                         Wildcat 2.x - A through Z,  plus 26 through  255 if
  446.                                       Tomcat's  extended folders  are being
  447.                                       used
  448.  
  449.                         Wildcat 3.x - 0 through 999
  450.  
  451.                         MajorBBS    - A valid SIG name (ie. /Hello).
  452.  
  453.                         UTI         - Whatever the UTI drivers expect for a
  454.                                       conference identifier.   See your UTI
  455.                                       driver    documentation    for   more
  456.                                       details.
  457.  
  458.     HUBNUM    - This is the hub conference  number which corresponds to the
  459.                 above conference.  Note  that if your hub  is a Wildcat 2.x
  460.                 system  using  Tomcat, then  A  through Z  are  accepted as
  461.                 substitutes for 0 through 25.
  462.  
  463.     PRIVATE   - This  yes/no  option  indicates   whether  or  not  private
  464.                 messages  in this  conference are  exported by  TNet.  Note
  465.                 that if a message is from  a user specified in the PRIVNAME
  466.                 section,  it will  always  be exported  regardless  of this
  467.                 setting.
  468.  
  469.     TAG       - This is  the tagline letter  for this  conference.  See the
  470.                 description of the IMPORTTAG and EXPORTTAG options for more
  471.                 information.
  472.  
  473.     NEXTMSG   - This is  the next  message number  to be  exported by TNet.
  474.                 This option is automatically  maintained by TNet and should
  475.                 not be changed under normal circumstances.
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495. ---------------------------------------------------------------------------
  496. Technique Computer Systems - TNET.DOC                               Page 8
  497.  
  498.  
  499.  
  500.     The following is a sample TNet configuration file:
  501.  
  502.     SYSTEM      = WILDCAT3
  503.     WORK        = E:\WORK
  504.     QWKDIR      = C:\QWK
  505.     REPDIR      = C:\REP
  506.     LOGFILE     = TNET.LOG
  507.     PACKER      = PKZIP -es ! , PKUNZIP -o !
  508.     APPEND      = Y
  509.     ATFILTER    = Y
  510.     VERBOSE     = N
  511.     TTAG        = Y
  512.     TCAN        = BOTHERSOME USER
  513.     PRIVNAME    = GREG HEWGILL
  514.     IMPORTTAG   = T , Hub BBS Name and Phone Number
  515.     EXPORTTAG   = T , Your BBS Name and Phone Number
  516.  
  517.     CONF        = 5
  518.       HUBNUM    = 62
  519.       PRIVATE   = Y
  520.       TAG       = T
  521.       NEXTMSG   = 0
  522.  
  523.     CONF        = 6
  524.       HUBNUM    = 66
  525.       PRIVATE   = N
  526.       TAG       = T
  527.       NEXTMSG   = 0
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557. ---------------------------------------------------------------------------
  558. Technique Computer Systems - TNET.DOC                               Page 9
  559.  
  560.  
  561.  
  562. Software Specific Notes
  563. -----------------------
  564.  
  565.     The   following   sections  contain   special   information  concerning
  566.     particular BBS types when used with TNet.
  567.  
  568.     Wildcat 2.x
  569.     -----------
  570.  
  571.     TNet should be run  from one of the node  home directories.  If you are
  572.     running a multi-line version of Wildcat,  make SURE that you do not run
  573.     TNet with the same node number  as another Wildcat node that is already
  574.     up on another  workstation!  Similarly, if you  are running DESQview or
  575.     other multitasker, TNet must  be run while one  of your regular Wildcat
  576.     nodes is down.  If you  are running single-line Wildcat under DESQview,
  577.     you MUST bring down Wildcat before running TNet!  Failure to do so will
  578.     corrupt your Wildcat databases.
  579.  
  580.     Conference identifiers  in Wildcat  2.x are  A through  Z.  If  you are
  581.     running  Tomcat  and  are  using   its  extended  folders  option,  the
  582.     additional folders are numbered 26 through 255.
  583.  
  584.     Wildcat 3.x
  585.     -----------
  586.  
  587.     TNet  should be  run from  your  Wildcat home  directory (the  one that
  588.     contains  MAKEWILD.DAT).   It  must  be  run  with  a  unique WCNODEID=
  589.     setting, or you will defeat the file locking mechanism and corrupt your
  590.     Wildcat databases.   If you are  running the single  line version under
  591.     DESQview, you MUST bring down Wildcat  before running TNet.  If you are
  592.     using the Autonode feature, TNet will find a free node number to use.
  593.  
  594.     Conference identifiers  in Wildcat 3.x  are numbered 0  through 999 (or
  595.     whatever  is  the  maximum  number  of  conferences  you  have  set  in
  596.     Makewild).
  597.  
  598.     MajorBBS
  599.     --------
  600.  
  601.     TNet should  be run  from your  main MajorBBS  directory (the  one that
  602.     contains  all  your  .DAT  files).   It  must  also  be  able  to  find
  603.     MAJORMSG.MSG in order  to determine what  the maximum size  of your SIG
  604.     messages  is  (it  does  this  by  looking  up  the  OUTBSZ  option  in
  605.     MAJORMSG.MSG).  Of course, Btrieve must be loaded before running TNet.
  606.  
  607.     Conference identifiers in MajorBBS are your SIG names.  When specifying
  608.     SIG  names,  the  leading  slash  is  not  necessary  and  case  is not
  609.     significant.  For example,
  610.  
  611.               CONF = /Hello
  612.               CONF = /hello
  613.     and       CONF = HELLO
  614.  
  615.     will all properly match the SIG /Hello.
  616.  
  617.  
  618.  
  619. ---------------------------------------------------------------------------
  620. Technique Computer Systems - TNET.DOC                               Page 10
  621.  
  622.  
  623.  
  624.     Other BBS Software with UTI Drivers
  625.     -----------------------------------
  626.  
  627.     If you are  running some other  type of BBS  software and have Revision
  628.     One UTI drivers  (RLY*.EXE), then TNet  will be able  to work with your
  629.     BBS software.   You will  need to  specify SYSTEM  = UTI1  in your TNet
  630.     configuration file.  You must run TNet from the same directory in which
  631.     the  UTI drivers  should  be run  (see  the documentation  for  the UTI
  632.     drivers to find out which directory this should be).
  633.  
  634.     Conference identifiers  must be whatever  the UTI  drivers expect.  For
  635.     example, the  RBBS UTIs  expect the path  and filename  of a conference
  636.     file.   This is  what  should be  specified  on the  TNet configuration
  637.     CONF= line.
  638.  
  639.     Please note that we cannot provide  support for you if your UTI drivers
  640.     are not working  correctly.  To find  out whether your  UTI drivers are
  641.     working, change to  the directory from  which you are  running TNet and
  642.     type
  643.               RLYEXPRT <conference> 1 TEST.DAT
  644.  
  645.     where  <conference> is  a conference  identifier  required by  your UTI
  646.     drivers.   When  this  is  complete, be  sure  that  the  file TEST.DAT
  647.     contains some of your BBS messages.  If TEST.DAT does not exist or does
  648.     not contain any messages, we cannot help you if TNet does not work.
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681. ---------------------------------------------------------------------------
  682. Technique Computer Systems - TNET.DOC                               Page 11
  683.  
  684.  
  685.  
  686. Running TNet
  687. ------------
  688.  
  689.     TNet can be run  manually from DOS, or from  a batch file.  Its command
  690.     line format is the same in either case:
  691.  
  692.               TNET [EXPORT|IMPORT|HIGH] [hubname]
  693.  
  694.     EXPORT - This command will tell TNet to  extract all new mail from your
  695.              message database and place it  in a [hubname].REP packet to be
  696.              uploaded to your hub.
  697.  
  698.     IMPORT - This command will tell TNet to extract a QWK packet and insert
  699.              all the messages in it into your message database.
  700.  
  701.     HIGH   - This command will tell TNet to  set the message number in each
  702.              conference  listed in  the .CFG  file  to the  highest message
  703.              number in the  corresponding conference on  the BBS.  Some BBS
  704.              software allows you to "renumber" the message base so messages
  705.              are numbered  sequentially starting  with 1.   If you renumber
  706.              your message base, you must use  the HIGH command to tell TNet
  707.              to reset all  message pointers to the  highest message in each
  708.              conference,  since  the  numbers   will  have  changed.   Just
  709.              remember  to  do one  last  export before  renumbering,  as no
  710.              messages will be exported immediately after running HIGH!
  711.  
  712.     Processing mail, step by step
  713.     -----------------------------
  714.  
  715.     1. Export  new local  mail.  Prepare  a  [hubname].REP packet  ready to
  716.        upload to your host by running:
  717.  
  718.               TNET EXPORT [hubname]
  719.  
  720.        TNet will call the config file matching the hubname.  Do not add the
  721.        .CFG extension to the hub name.
  722.  
  723.        TNet will then log  its activity to the console  and to the log file
  724.        specified in [hubname].CFG.   TNet will create  [hubname].REP in the
  725.        directory specified in the config  file.  It should be the directory
  726.        in which Robocomm or your  communications script expects to find the
  727.        .REP file.
  728.  
  729.     2. Collect new  mail from  your host.   Call your  hub, enter  the mail
  730.        door,  upload your  .REP packet,  and then  download a  .QWK packet.
  731.        Please remember  to rename  or delete the  .REP packet  after it has
  732.        successfully been uploaded so you don't upload it again.
  733.  
  734.     3. Import new incoming mail.  Import the newly downloaded messages into
  735.        your BBS by calling TNet with the following parameters:
  736.  
  737.               TNET IMPORT [hubname]
  738.  
  739.        TNet will extract and  index the .QWK packet  you just received, and
  740.        insert the messages  into your database.  A  full report will appear
  741.        on the local console and will also be logged to a disk file.
  742.  
  743. ---------------------------------------------------------------------------
  744. Technique Computer Systems - TNET.DOC                               Page 12
  745.  
  746.  
  747.  
  748. Network Sysop Message Support
  749. -----------------------------
  750.  
  751.     TNet supports "network  sysop" messages.  These  are messages that will
  752.     appear as a personal message to each sysop on a network.
  753.  
  754.     If, when  importing a  message, the message  has a  subject that begins
  755.     with !NS! and the message is to  ALL or NETWORK SYSOP, then the message
  756.     will  be posted  to the  sysop  in addition  to being  posted normally.
  757.     Depending on the  BBS type, "posted  to the sysop"  will mean different
  758.     things.
  759.  
  760.     If, when  importing a  message, the message  has a  subject that begins
  761.     with !NS! but the message is NOT to ALL, then the subject is changed to
  762.     start with (NS).  This is so that,  as replies to an !NS! message drift
  763.     back up the network, their subjects are modified from !NS! to (NS).
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805. ---------------------------------------------------------------------------
  806. Technique Computer Systems - TNET.DOC                               Page 13
  807.  
  808.  
  809.  
  810. Appendix A: Error Messages
  811. --------------------------
  812.  
  813.     Fatal errors will display a bright  white flashing error message on the
  814.     screen, pause  for five  seconds, and  exit to  DOS with  errorlevel 1.
  815.     TNet will also create or append  to TNET.ERR with a message showing the
  816.     date, time, and a description of the error.
  817.  
  818.     Fatal errors most commonly result from a non-net status or missing .QWK
  819.     packet, insufficient RAM or disk space, inability to find PKZIP/PKUNZIP
  820.     in  the   path,  a   serious  disk   I/O  error,   or  severe  database
  821.     corruption.
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867. ---------------------------------------------------------------------------
  868. Technique Computer Systems - TNET.DOC                               Page 14
  869.  
  870.  
  871.  
  872. Appendix B: Message Networks Supporting TNet
  873. --------------------------------------------
  874.  
  875.     There are many public message networks  available to choose from if you
  876.     would like to  join a network.  The  following is a  short list of some
  877.     major worldwide networks and their main hubs and BBS phone numbers:
  878.  
  879.     ILink     Executive Network ... Andy Keeves ...... (914) 667-4684
  880.               Microsellar ......... Mark Rapp ........ (201) 239-1346
  881.  
  882.     U'NI-Net  The Ledge ........... Joe Sheppard ..... (818) 352-3620
  883.               Rose Media .......... Vic Kass ......... (416) 733-2285
  884.  
  885.     Intelec   Intelec ............. Cliff Watkins .... (516) 867-4448
  886.  
  887.     Wildnet   North Georgia ....... Johnnie Yother ... (404) 226-4388
  888.  
  889.     Throbnet  Heart Throb BBS (adult) ................ (908) 381-5682
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929. ---------------------------------------------------------------------------
  930. Technique Computer Systems - TNET.DOC                               Page 15
  931.  
  932.  
  933.  
  934. Appendix C: Disclaimer
  935. ----------------------
  936.  
  937.     You use this program (just like any  other one) at your own risk, so be
  938.     careful.   Read  the  documentation,   follow  instructions,  and  make
  939.     backups.  We  can't guarantee  that this  program will  work with every
  940.     possible combination  of hardware  and software  out there  in the real
  941.     world (or that  it will work at  all, for that  matter).  While we have
  942.     done our best  to produce a  well-written, bug-free program, oversights
  943.     and omissions can happen.
  944.  
  945.     No  software  program (not  even  DOS)  is completely  safe  from bugs,
  946.     glitches, and "stupid  user tricks".  We cannot  be responsible for any
  947.     damages  which  might occur  as  a  result of  using  TNet.   We cannot
  948.     guarantee it will be "safe" or "harmless" in all possible applications,
  949.     and any lost time, data, hardware, or software you incur as a result of
  950.     using TNet is your responsibility alone.  If this disclaimer isn't good
  951.     enough for you, don't use TNet.
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991. ---------------------------------------------------------------------------
  992. Technique Computer Systems - TNET.DOC                               Page 16
  993.  
  994.  
  995.  
  996. Appendix D: Acknowledgements
  997. ----------------------------
  998.  
  999.     Thanks to all of those who have helped directly and indirectly with the
  1000.     development  of TNet:   in  particular, Rick  Kunz  of the  now defunct
  1001.     Poverty  Rock  PCBoard  in Seattle,  WA.   Without  Rick's  good humor,
  1002.     saintly patience  and hard work,  this project would  never have gotten
  1003.     off the ground.
  1004.  
  1005.     The  following people,  in no  particular  order, deserve  an honorable
  1006.     mention for their participation in this project:
  1007.  
  1008.               Allen Dietz              Tom McElvy
  1009.               Walter Scott             Bill Nolan
  1010.               Keith Birch              Jimmy Pearson
  1011.               Art Hill                 Bob Hogan
  1012.               Jerry Houston            Cliff Watkins
  1013.               Klaus Lamort             Paul Waldinger
  1014.               Rob Morrow               Joe Sheppard
  1015.               Skip Guyer               Robert Vostreys
  1016.               Dan Boss
  1017.  
  1018.     Please DO  NOT sell,  transfer, or give  away copies  of the registered
  1019.     version of  TNet.  That's  piracy and  it's not  fair.  If  you want to
  1020.     re-sell or  transfer your  license to use  TNet, please  contact us for
  1021.     information FIRST.
  1022.  
  1023.     - Qmail, Qdeluxe and Deluxe² are trademarks of Mark "Sparky" Herring.
  1024.     - MarkMail is a trademark of Mark Turner.
  1025.     - EZ-Reader is a trademark of Thumper Technologies and Eric Cockrell.
  1026.     - Wildcat! is a trademark of Mustang Software, Inc.
  1027.     - MajorBBS is a trademark of Galacticomm, Inc.
  1028.     - PCBoard is a trademark of Clark Development Corporation.
  1029.     - PKZIP is a trademark of Phil Katz and PKWare.
  1030.     - Novell is a trademark of Novell.
  1031.     - LANtastic is a trademark of Artisoft.
  1032.     - DESQview is a trademark of Quarterdeck Office Systems.
  1033.     - Turbo Pascal is a trademark of Borland International.
  1034.     - MS-DOS is a trademark of Microsoft.
  1035.     - PC-DOS, PC, XT, AT and PS/2 are all trademarks of IBM Corporation.
  1036.  
  1037.     This program, its documentation and support files are all (c) Copyright
  1038.     1990-91 by Greg Hewgill and Technique Computer Systems.  You may make a
  1039.     reasonable number of backup copies of  this program, and you may freely
  1040.     distribute the Demonstration Version of TNet in its original, unaltered
  1041.     archive(s).   Please  don't  add or  remove  files  within  the archive
  1042.     itself, but you may, if  you wish, insert a ZIP  comment of your own to
  1043.     advertise your BBS.  You probably will anyway, so we might as well give
  1044.     you permission to do so up front.   Please DON'T put files of your own,
  1045.     including BBS ads, inside the archive.
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053. ---------------------------------------------------------------------------
  1054. Technique Computer Systems - TNET.DOC                               Page 17
  1055.